/*----------------------------------------------------------------------------*\
                              ====================
                               YSI - Master Funcs
                              ====================
Description:
	Defines new names for native functions.
Legal:
	Version: MPL 1.1
	
	The contents of this file are subject to the Mozilla Public License Version 
	1.1 (the "License"); you may not use this file except in compliance with 
	the License. You may obtain a copy of the License at 
	http://www.mozilla.org/MPL/
	
	Software distributed under the License is distributed on an "AS IS" basis,
	WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
	for the specific language governing rights and limitations under the
	License.
	
	The Original Code is the YSI master include.
	
	The Initial Developer of the Original Code is Alex "Y_Less" Cole.
	Portions created by the Initial Developer are Copyright (C) 2011
	the Initial Developer. All Rights Reserved.
	
	Contributors:
		ZeeX, koolk, JoeBullet/Google63, g_aSlice/Slice
	
	Thanks:
		JoeBullet/Google63 - Handy arbitrary ASM jump code using SCTRL.
		ZeeX - Very productive conversations.
		koolk - IsPlayerinAreaEx code.
		TheAlpha - Danish translation.
		breadfish - German translation.
		Fireburn - Dutch translation.
		yom - French translation.
		50p - Polish translation.
		Zamaroht - Spanish translation.
		Dracoblue, sintax, mabako, Xtreme, other coders - Producing other modes
			for me to strive to better.
		Pixels^ - Running XScripters where the idea was born.
		Matite - Pestering me to release it and using it.
	
	Very special thanks to:
		Thiadmer - PAWN, whose limits continue to amaze me!
		Kye/Kalcor - SA:MP.
		SA:MP Team past, present and future - SA:MP.
	
Version:
	0.2
Changelog:
	21/10/10:
		Split in to y_shortfunc.
Functions:
	Public:
		-
	Core:
		-
	Stock:
		-
	Static:
		-
	Inline:
		-
	API:
		-
	Hooks:
		-
Callbacks:
	-
Definitions:
	-
Enums:
	-
Macros:
	-
Tags:
	-
Variables:
	Global:
		-
	Static:
		-
Commands:
	-
Compile options:
	-
Operators:
	-
Natives:
	W@ - Renaming of CallRemoteFunction for size reasons.
	V@ - Renaming of getproperty for size reasons.
	S@ - Renaming of setproperty for size reasons.
	P@ - Renaming of CallLocalFunction for size reasons.
\*----------------------------------------------------------------------------*/

#include <YSI\y_utils>
#include <YSI\y_debug>

// Public variable.
public stock
	_@ = -1;

// J@ is a "nul" target - send things there if they need ignoring or if a
// parameter needs using.
stock
	J@;

// N@ taken by y_uvar.
// M@ taken by y_svar.
// I@ taken by y_timers.

native U@(id=0, const name[]="", value=cellmin, const string[]="") = setproperty;

native V@(id=0, const name[]="", value=cellmin, string[]="") = getproperty;

// Define this command with basically every strong tag in existance to avoid
// tag mismatch warnings with remote functions with strong tag parameters.
native W@(const function[], const format[], GLOBAL_TAG_TYPES:...) = CallRemoteFunction;

native P@(const function[], const format[], GLOBAL_TAG_TYPES:...) = CallLocalFunction;

native O@(const function[], time, repeat, const format[], GLOBAL_TAG_TYPES:...) = SetTimerEx;

native K@(const function[], time, repeat) = SetTimer;

stock X@(n)
{
	P:3("X@ called: %i", n);
	setproperty(8, YSIM_RETURN, n);
}

stock Y@()
{
	P:3("Y@ called");
	new
	    ret = getproperty(8, YSIM_CALLER);
	setproperty(8, YSIM_CALLER, _@);
	return ret;
}

stock Z@(GLOBAL_TAG_TYPES:v = -1)
{
	P:3("Z@ called");
	setproperty(8, YSIM_CALLER, v);
	return getproperty(8, YSIM_RETURN);
}

stock T@()
{
	P:3("T@ called");
	setproperty(8, YSIM_CALLER, -1);
}

new Q@[YSI_MAX_STRING];

stock S@(GLOBAL_TAG_TYPES:v = -1)
{
	P:3("S@ called");
	getproperty(8, "", YSIM_STRING, Q@);
	strunpack(Q@, Q@);
	setproperty(8, YSIM_CALLER, v);
	return 0;
}

stock R@(buffer[])
{
	P:3("R@ called: \"%s\"", buffer);
	return setproperty(8, "", YSIM_STRING, buffer);
}

stock H@(GLOBAL_TAG_TYPES:...)
{
	// Just a dead-end for spare parameters.
	return 0;
}

stock G@(GLOBAL_TAG_TYPES:...)
{
	// Just a dead-end for spare parameters which returns a string.
	return Q@;
}

// Consume trailing spaces.  Despite being a common letter, this is unlkely to
// ever be matched due to the unusual series of operators after it.  If anyone
// else tries to define "x" however they may have a slight problem (they can't).
//#define x,), x),
// Changed as x,): was also needed (for ?:).
#define x,) x)

// This is for getting excess parameters on non-strings.
#define _:%0,) %0)

// Used to get rid of the "string:" tag once it has been used.
#define string:
